祖师爷Linus被内核维护者整烦了,别再被be被be被be噢噢!
他希望内核维护者在描述 PR 中的变更时避免使用被动语态,应当使用主动语态——并且最好直接使用祈使句 (Imperative)。
我希望自己合并的 commit 信息保持一定的“统一性”,所以我经常编辑 Pull Request 的语言,使其符合更标准的布局和语言。
这不是很大的问题,通常只是留白而已,这样我们就不会有 15 种不同的缩进模式和项目符号语法。
反正我一般都是在阅读文本的时候做的,所以也不会给我带来额外的工作。
但是,当一些维护者使用被动语态时,我会尝试主动重写注释,而这会增加额外的工作量。
因此我会要求维护者使用主动语态,最好是祈使句。
换一种说法:
如果大家能避免将描述写成 “In this pull request, the Xyzzy driver error handling was fixed to avoid a NULL pointer dereference”,我会非常高兴。
可以写成 “This fixes a NULL pointer dereference in ..”;
或者,如果希望列出要点,则可以直接写成 “Fix NULL pointer dereference in ..”。
我知道这不是什么大问题。但上周我碰巧试着重写了几个这样的案例,我觉得简洁明了的语言更好。
比如用祈使句语法的 “Fix X” 就已经很清楚了。
不过小编作为常年浏览大量英文内容的人,这次强烈支持祖师爷的观点,因为这种被动语态确实太烦人了。
对了,如果你不知道本文封面图的含义,请欣赏下面歌曲:
https://lore.kernel.org/lkml/CAHk-=wgMS-TBfirwuxf+oFA3cTMWVLik=w+mA5KdT9dAvcvhTA@mail.gmail.com/
END
热门文章
Rust非常安全编程语言,使Android漏洞大幅下降高通拟收购英特尔——Arm与x86之争到此为止?“革命性”「Safe C++」扩展提案:质疑Rust、理解Rust、成为Rust?
我有一个大胆的想法:呼吁Linus延迟退休!Zen浏览器——号称是“开源版Arc”、轻如鸿毛、快如闪电